<!doctype html>
<html lang=en>
<head>
<meta charset=utf-8>
<title>List</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.10.1/css/all.min.css" integrity="sha512-9my9Mb2+0YO+I4PUCSwUYO7sEK21Y0STBAiFEYoWtd2VzLEZZ4QARDrZ30hdM1GlioHJ8o8cWQiy8IAb1hy/Hg==" crossorigin="anonymous" referrerpolicy="no-referrer" />
<style>@import "dist/ourbigbook.css";

</style>
<link rel="stylesheet" type="text/css" href="main.css">
</head>
<body>
<header>
<a href="/">Ciro Santilli???</a>
<a href=".">Ourbigbook!!!</a>
<a class="font-awesome-container" href="https://github.com/cirosantilli/ourbigbook"><i class="fab fa-github fa-fw"></i></a>
</header>
<main class="ourbigbook">
<div><span class="hide-hover"><a href=".#list"><span class="fa-solid-900"></span></a></span><div class="h" id="list"><h1><a href="" title="link to this element">List (<code>* </code>, <code>\L</code>, <code>\Ul</code>, <code>\Ol</code>)</a></h1>
<span class="hover-meta"> <span class="sep"></span><a title="view all headers in a single page" href=".#list"><span class="fa-solid-900"></span> nosplit</a><span class="sep"></span><a href=".#macro" title="parent header"><span class="fa-solid-900"></span> "Macro"</a><span class="sep"></span><span class="metrics"><span title="word count for this node + all descendants"><span class="fa-regular-400"></span> words: <span class="word-count-descendant">346</span></span></span></span></div><nav class="h-nav h-nav-toplevel"><div class="nav"> <span title="tags" class="fa-solid-900"></span> tags: <a href=".#macros-with-insane-shortcut" title="internal link
word count: 3
descendant word count: 363
descendant count: 33">Macros with insane shortcut</a></div><div class="nav"> <a href=".#macro" title="parent header"><span class="fa-solid-900"></span> "Macro"</a><span class="sep"></span><a title="view all headers in a single page" href=".#list"><span class="fa-solid-900"></span> nosplit</a><span class="sep"></span><a href="#toc"><span class="fa-solid-900"></span> toc</a><span class="sep"></span><span class="metrics"><span title="word count for this node + all descendants"><span class="fa-regular-400"></span> words: <span class="word-count-descendant">346</span></span></span></div></nav>
</div><div><span class="hide-hover"><a href="#_1113"><span class="fa-solid-900"></span></a></span><div class="p" id="_1113"><a href=".#insane-macro-shortcuts" title="internal link
word count: 4
descendant word count: 427
descendant count: 64">Insane</a> with <code>* </code> (asterisk space):
<div class="code" id="_1114">
<pre><code>* a
* b
* c
</code></pre></div><div class="p" id="_1115">which renders as:</div><blockquote id="_1116"><div><ul id="_1117">
<li id="_1118">a</li>
<li id="_1119">b</li>
<li id="_1120">c</li>
</ul></div></blockquote></div></div><div><span class="hide-hover"><a href="#_1121"><span class="fa-solid-900"></span></a></span><div class="p" id="_1121">Equivalent saner with <a href=".#auto-parent" title="internal link
word count: 0
descendant word count: 54
descendant count: 54">implicit <code>ul</code> container</a>:
<div class="code" id="_1122">
<pre><code>\L[a]
\L[b]
\L[c]
</code></pre></div><div class="p" id="_1123">which renders as:</div><blockquote id="_1124"><div><ul id="_1125">
<li id="_1126">a</li>
<li id="_1127">b</li>
<li id="_1128">c</li>
</ul></div></blockquote></div></div><div><span class="hide-hover"><a href="#_1129"><span class="fa-solid-900"></span></a></span><div class="p" id="_1129">Equivalent fully sane with explicit container:
<div class="code" id="_1130">
<pre><code>\Ul[
\L[a]
\L[b]
\L[c]
]
</code></pre></div><div class="p" id="_1131">which renders as:</div><blockquote id="_1132"><div><ul id="_1133">
<li id="_1134">a</li>
<li id="_1135">b</li>
<li id="_1136">c</li>
</ul></div></blockquote></div></div><div><span class="hide-hover"><a href="#_1137"><span class="fa-solid-900"></span></a></span><div class="p" id="_1137">The explicit container is required if you want to pass extra arguments properties to the <code>ul</code> list macro, e.g. a title and an ID: <a href="#list-my-id" title="internal link
word count: 0
descendant word count: 0
descendant count: 0">Ul 1</a>:
<div class="code" id="_1138">
<pre><code>\Ul
{id=list-my-id}
[
\L[a]
\L[b]
\L[c]
]
</code></pre></div><div class="p" id="_1139">which renders as:</div><blockquote id="_1140"><div><ul id="list-my-id">
<li id="_1141">a</li>
<li id="_1142">b</li>
<li id="_1143">c</li>
</ul></div></blockquote>
This is the case because without the explicit container in an implicit <code>ul</code> list, the arguments would stick to the last list item instead of the list itself.</div></div><div><span class="hide-hover"><a href="#_1144"><span class="fa-solid-900"></span></a></span><div class="p" id="_1144">It is also required if you want ordered lists:
<div class="code" id="_1145">
<pre><code>\Ol[
\L[first]
\L[second]
\L[third]
]
</code></pre></div><div class="p" id="_1146">which renders as:</div><blockquote id="_1147"><ol id="_1148">
<li id="_1149">first</li>
<li id="_1150">second</li>
<li id="_1151">third</li>
</ol></blockquote></div></div><div><span class="hide-hover"><a href="#_1152"><span class="fa-solid-900"></span></a></span><div class="p" id="_1152">Insane nested list with two space indentation:
<div class="code" id="_1153">
<pre><code>* a
  * a1
  * a2
  * a2
* b
* c
</code></pre></div><div class="p" id="_1154">which renders as:</div><blockquote id="_1155"><div><ul id="_1156">
<li id="_1157">a<div><ul id="_1158">
<li id="_1159">a1</li>
<li id="_1160">a2</li>
<li id="_1161">a2</li>
</ul></div></li>
<li id="_1162">b</li>
<li id="_1163">c</li>
</ul></div></blockquote>
The indentation must always be exactly equal to two spaces, anything else leads to errors or unintended output.</div></div><div><span class="hide-hover"><a href="#_1164"><span class="fa-solid-900"></span></a></span><div class="p" id="_1164">Equivalent saner nested lists with implicit containers:
<div class="code" id="_1165">
<pre><code>\L[
a
\L[a1]
\L[a2]
\L[a2]
]
\L[b]
\L[c]
</code></pre></div><div class="p" id="_1166">which renders as:</div><blockquote id="_1167"><div><ul id="_1168">
<li id="_1169">a
<div><ul id="_1170">
<li id="_1171">a1</li>
<li id="_1172">a2</li>
<li id="_1173">a2</li>
</ul></div></li>
<li id="_1174">b</li>
<li id="_1175">c</li>
</ul></div></blockquote></div></div><div><span class="hide-hover"><a href="#_1176"><span class="fa-solid-900"></span></a></span><div class="p" id="_1176">Insane list item with a paragraph inside of it:
<div class="code" id="_1177">
<pre><code>* a
* I have

  Multiple paragraphs.

  * And
  * also
  * a
  * list
* c
</code></pre></div><div class="p" id="_1178">which renders as:</div><blockquote id="_1179"><div><ul id="_1180">
<li id="_1181">a</li>
<li id="_1182"><div class="p" id="_1183">I have</div><div class="p" id="_1184">Multiple paragraphs.</div><div><ul id="_1185">
<li id="_1186">And</li>
<li id="_1187">also</li>
<li id="_1188">a</li>
<li id="_1189">list</li>
</ul></div></li>
<li id="_1190">c</li>
</ul></div></blockquote></div></div><div><span class="hide-hover"><a href="#_1191"><span class="fa-solid-900"></span></a></span><div class="p" id="_1191">Equivalent sane version:
<div class="code" id="_1192">
<pre><code>\L[a]
\L[
I have

Multiple paragraphs.

\L[And]
\L[also]
\L[a]
\L[list]
]
\L[c]
</code></pre></div><div class="p" id="_1193">which renders as:</div><blockquote id="_1194"><div><ul id="_1195">
<li id="_1196">a</li>
<li id="_1197"><div class="p" id="_1198">I have</div><div class="p" id="_1199">Multiple paragraphs.</div><div><ul id="_1200">
<li id="_1201">And</li>
<li id="_1202">also</li>
<li id="_1203">a</li>
<li id="_1204">list</li>
</ul></div></li>
<li id="_1205">c</li>
</ul></div></blockquote></div></div><div><span class="hide-hover"><a href="#_1206"><span class="fa-solid-900"></span></a></span><div class="p" id="_1206">Insane lists may be escaped with a backslash as usual:
<div class="code" id="_1207">
<pre><code>\* paragraph starting with an asterisk.
</code></pre></div><div class="p" id="_1208">which renders as:</div><blockquote id="_1209"><div class="p" id="_1210">* paragraph starting with an asterisk.</div></blockquote></div></div><div><span class="hide-hover"><a href="#_1211"><span class="fa-solid-900"></span></a></span><div class="p" id="_1211">You can also start insane lists immediately at the start of a <a href=".#positional-vs-named-arguments" title="internal link
word count: 4
descendant word count: 393
descendant count: 270">positional or named argument</a>, e.g.:
<div class="code" id="_1212">
<pre><code>\P[* a
* b
* c
]
</code></pre></div><div class="p" id="_1213">which renders as:</div><blockquote id="_1214"><div class="p" id="_1215"><div><ul id="_1216">
<li id="_1217">a</li>
<li id="_1218">b</li>
<li id="_1219">c
</li>
</ul></div></div></blockquote></div></div><div><span class="hide-hover"><a href="#_1220"><span class="fa-solid-900"></span></a></span><div class="p" id="_1220">And now a list outside of <a href=".#ourbigbookexample" title="internal link
word count: 0
descendant word count: 57
descendant count: 57"><code>\OurbigbookExample</code></a> to test how it looks directly under <a href=".#toplevel" title="internal link
word count: 0
descendant word count: 105
descendant count: 105">the <code>\Toplevel</code> implicit macro</a>:</div></div><div><span class="hide-hover"><a href="#_1221"><span class="fa-solid-900"></span></a></span><div><ul id="_1221">
<li id="_1222">a</li>
<li id="_1223">b</li>
<li id="_1224">c</li>
</ul></div></div><div><span class="hide-hover"><a href="#toc"><span class="fa-solid-900"></span></a></span></div><div><span class="hide-hover"><a href="#ancestors"><span class="fa-solid-900"></span></a></span><h2 id="#ancestors"><a href="#ancestors">Ancestors</a></h2></div>
<div><ul>
<li><a href=".#macro" title="internal link
word count: 155
descendant word count: 14k
descendant count: 14">Macro</a></li>
<li><a href="." title="internal link
word count: 296
descendant word count: 32k
descendant count: 234">OurBigBook</a></li>
</ul></div><div><span class="hide-hover"><a href="#incoming-links"><span class="fa-solid-900"></span></a></span><h2 id="incoming-links"><a href="#incoming-links">Incoming links</a></h2></div>
<div><ul>
<li><a href=".#argument-leading-newline-removal" title="internal link
word count: 0
descendant word count: 119
descendant count: 119">Argument leading newline removal</a></li>
<li><a href=".#auto-parent" title="internal link
word count: 0
descendant word count: 54
descendant count: 54"><code>auto_parent</code> macro property</a></li>
<li><a href=".#macros-with-insane-shortcut" title="internal link
word count: 3
descendant word count: 363
descendant count: 33">Macros with insane shortcut</a></li>
<li><a href=".#table" title="internal link
word count: 1
descendant word count: 492
descendant count: 427">Table</a></li>
</ul></div></main>
<footer>
<div>License: <a href="https://creativecommons.org/licenses/by-sa/4.0/">CC BY-SA 4.0</a> unless noted</div>
<div>Website source code: <a href="https://github.com/cirosantilli/ourbigbook">https://github.com/cirosantilli/ourbigbook</a></div>
<div>Website Git version: <a href="https://github.com/cirosantilli/ourbigbook/commit/72b4ad0343402d4c826196c7d9bc27ae17c31e1d">72b4ad0343402d4c826196c7d9bc27ae17c31e1d</a></div>
</footer>
<script>
<!-- Google Analytics, AKA selling my soul to Google for some backlinks. -->
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-47867706-1', 'auto');
ga('send', 'pageview');
</script>
<script src="dist/ourbigbook_runtime.js"></script>
<script>ourbigbook_runtime.ourbigbook_runtime()</script>
</body>
</html>
